Voicebot Conversation

The icon for the Voicebot Conversation action.

Integra um agente virtual de autoatendimento Um aplicativo de software que interage com os clientes no lugar de um agente humano ao vivo. com scripts de voz. Seu agente virtual deve oferecer suporte para esta ação.

A ação Voicebot Conversation é para uso somente com bots muito simples ou quando você usa uma conexão de retorno de canal SIP Protocolo usado para sinalizar e controlar sessões de comunicação multimídia, como chamadas de voz e vídeo.. Ela não permite que o script do Studio personalize ou controle o comportamento do agente virtual de turno a turno. Se precisar personalizar o comportamento do agente virtual entre os turnos da conversa e se o provedor do agente virtual fornecer tal suporte, use a ação Voicebot Exchange.

Esta ação interage diretamente com o agente virtual e monitora passivamente a conversa em tempo real. O agente virtual analisa a intenção O significado ou propósito por trás do que um contato diz/digita; o que o contato quer comunicar ou alcançar. e o contexto da conversa a partir de um fluxo de áudio constante. Ele retorna as respostas apropriadas para o contato. Quando o agente virtual indica que a conversa terminou, a ação continua o script Studio. A ação transmite qualquer informação relevante para pop-ups de tela Estado que permite que um agente conclua os requisitos de trabalho após terminar uma interação., roteamento de agentes e assim por diante.

Esta ação não é recomendada para uso com Google Dialogflow ES. Também não é recomendada para uso com Google Dialogflow CX a não ser que você esteja usando uma conexão canal de retorno SIP.

Clicar duas vezes nesta ação abre o Hub de Agente Virtual, onde você pode gerenciar todos os seus agentes virtuais.

Supported Script Types

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

Telefone

Comparison of Similar Actions

As ações a seguir têm funções semelhantes, mas com algumas diferença importantes.

Textbot Conversation: This action is only suitable for very simple virtual agents. It doesn't allow for customization of the virtual agent's behavior from turn to turn. It's not currently supported in CXone.
Textbot Exchange: esta action é usada para interações de agentes virtuais complexos. Ela permite incluir parâmetros de troca e personalizar vários aspectos da conversa entre contato e agente virtual.
Voicebot Conversation: esta action é adequada apenas para agentes virtuais muito simples. Ela não permite a personalização do comportamento do agente virtual de turno para turno. Se quiser usar uma conexão de canal de retorno SIP e seu agente suportá-la, você deverá usar Voicebot Conversation.
Voicebot Exchange: esta action é usada para interações de agentes virtuais complexos. Ela permite incluir parâmetros de troca e personalizar vários aspectos da conversa entre contato e agente virtual.

Supported Virtual Agents

Esta ação é compatível com os seguintes agentes virtuais:

CXone SmartAssist Powered by Amelia (não recomendado)
Google Dialogflow CX (não recomendado)
Google Dialogflow ES (não recomendado)

Antes de atribuir um bot de agente virtual a essa ação, você deve adicionar e configurar um app para o agente virtual no Hub de Agente Virtual. Você precisa de apenas um app para cada agente virtual que usa. Você pode atribuir o mesmo app para várias ações de agente virtual nos seus scripts. Consulte a página de ajuda do fornecedor do agente virtual que você está usando para ver detalhes de configuração.

Input Properties

Estas propriedades definem dados que a ação usa durante a execução.

Propriedade	Descrição
virtualAgentID	O nome do agente virtual selecionado no Hub de Agente Virtual. Quando você atribui um aplicativo de agente virtual a uma ação Studio no Hub de Agente Virtual, ele preenche automaticamente esta propriedade. O nome é o nome usado no campo Virtual Agent (Bot) Name no aplicativo Hub de Agente Virtual.
customPayload	Configure esta propriedade apenas se precisar passar dados de carga útil personalizados ao agente virtual. O objeto de carga útil personalizada é preenchido a partir do script Studio. Você pode usá-lo para passar informações como o nome do contato de um CRM Sistemas de terceiros que gerenciam itens como contatos, informações de vendas, detalhes de suporte e históricos de casos. para ser usado em uma mensagem de boas-vindas. Insira o nome de um objeto JSON que passa dados do script para o agente virtual. Você deve definir o objeto de carga útil personalizada em uma ação Snippet. O objeto deve ser convertido para JSON no snippet ou na propriedade customPayload. Requisitos para fornecedores de agentes virtuais específicos: Amazon Lex V1: Esta propriedade é necessária mesmo que você não precise passar informações ao agente virtual. Adicione um snippet com um valor de espaço reservado. Google Dialogflow ES: Esta propriedade é usada para passar o contexto para uma intenção O significado ou propósito por trás do que um contato diz/digita; o que o contato quer comunicar ou alcançar.. Revise as melhores práticas para carga útil personalizada com Google Dialogflow ES para garantir que lide com ela adequadamente. Google Dialogflow CX: revise as melhores práticas para carga útil personalizada com Google Dialogflow CX para garantir que lide com ela adequadamente. Não use essa propriedade se precisar processar dados que o agente virtual retorna ao script. Em vez disso, use a variável customPayloadVarName (out).
maxTimeouts	Define o número de trocas sem expressão antes de rotear para a ramificação de fallback de erro.
maxNotUnderstood	Define o número de trocas de reconhecimento de intent com falha antes de rotear para o branch de fallback de erro.

Output Properties

Estas propriedades contêm variáveis que armazenam dados retornados da execução da ação. Elas estão disponíveis para referência e uso quando a ação é concluída.

Propriedade	Descrição
customPayloadVarName (out)	Retorna dados JSON personalizados do agente virtual para o script. Use essa variável quando quiser que o script processe os dados fornecidos pelo agente virtual. Pode conter dados de preenchimento. Se você quiser fornecer dados ao agente virtual, use a propriedade customPayload.
errorDetailsVarName (out)	Solicita a sequência de intenção de erro; pode levar a uma transferência para um agente vivo.
intentInfoVarName (out)	Uma variável que contém detalhes do agente virtual, indicando a intenção atual do usuário.

Propriedade

Descrição

customPayloadVarName (out)

Retorna dados JSON personalizados do agente virtual para o script. Use essa variável quando quiser que o script processe os dados fornecidos pelo agente virtual. Pode conter dados de preenchimento.

Se você quiser fornecer dados ao agente virtual, use a propriedade customPayload.

errorDetailsVarName (out)

Solicita a sequência de intenção de erro; pode levar a uma transferência para um agente vivo.

intentInfoVarName (out)

Uma variável que contém detalhes do agente virtual, indicando a intenção atual do usuário.

Result Branch Conditions

Condições de ramal resultante permitem que você crie ramais no seu script para atender diferentes resultados quando uma ação é executada.

Condição	Descrição
OnBotSessionComplete	Caminho tomado quando o agente virtual indica que a conversa terminou. If you're using a SIP backchannel connection and want the virtual agent to be able to pass the contact back to the script to talk to a live agent, you must include the Live Agent Handoff snippet in your script.
OnError	Caminho percorrido quando há um problema inesperado (por exemplo, conectividade ruim, erros de sintaxe e assim por diante). A variável _ERR deve ser preenchida com uma explicação condensada do problema.
OnDTMFBreakout	Caminho tomado quando uma regra DTMF Tons de sinalização gerados quando um usuário pressiona ou toca em uma tecla do teclado do telefone. no script foi cumprida.
OnUserInputTimeout	Caminho tomado quando não há resposta do usuário no tempo especificado no snippet de Comportamento de prompt (seja ele Padrão ou o snippet de Próximo comportamento de prompt). Para o Google Dialogflow, você pode configurar o evento que deseja que aconteça no aplicativo Hub de Agente Virtual Dialogflow. Para o ES Dialogflow, configure o campo Timeout Event . Para o CX Dialogflow, configure o Timeout Event Handler. Se nenhum evento estiver configurado, o padrão é usar a intenção de fallback padrão conforme configurado no console Dialogflow. Se desejar, você pode configurar esse ramal para usar eventos diferentes em pontos diferentes do seu script.
OnUserInputNotUnderstood	Caminho tomado quando o agente virtual não entende a resposta do contato ou quando o contato expira.

Snippet Action Code

Uma ou mais propriedades desta ação exigem uma action Snippet com o seguinte código personalizado:

Carga útil personalizada.
Transferência ao agente em tempo real (apenas para conexões de canal de retorno SIP).

Best Practices for Custom Payload with Google Dialogflow CX

When using this action with Google Dialogflow CX. follow these best practices for integrating custom payloads:

Dialogflow O CX não usa contextos para passar dados para Dialogflowintents O significado ou propósito por trás do que um contato diz/digita; o que o contato quer comunicar ou alcançar. como o DialogflowES faz.
Você pode passar dados personalizados para o CX Dialogflowusando pares de valores-chave JSON. Em uma actionação Snippet no seu script, crie um objeto customPayload dinâmico e adicione os pares de chave-valor a ele. Por exemplo:
```
DYNAMIC customPayload
customPayload.ani = ani
customPayload.contactID = contactId
customPayload.masterContactId = masterId
customPayloadJSON = "{customPayload.asJSON()}"	
```
Na ação Exchange ou Conversation no seu script, configure a propriedade customPayload com a variável que tem a função asJSON() em seu valor. Você pode encontrar essa variável no objeto customPayload.
Passe o JSON customPayload para o agente virtual usando a propriedade Payload de QueryParameters. Consulte a documentação do Google sobre QueryParameters para Google Dialogflow CX.
Os dados passados por QueryParameters são recebidos por um webhook no Dialogflow CX. Você pode escrever código no console CX Dialogflowpara manipular os dados passados.
Não aninhe um objeto dentro do objeto customPayload. Os objetos são enviados como strings literais.
Para passar dados personalizados do agente virtual Dialogflow CX de volta ao script, use o campo Carga útil personalizada no console Dialogflow CX. Verifique se você está no console do agente virtual que está usando CXone. Mapeie isso para o seu script usando a variável customPayloadVarName (out) na ação voice ou chat Studio no seu script. Por exemplo, você pode usar isso para definir os comportamentos do próximo prompt.
Os parâmetros definidos usando customPayload só podem ser usados no webhook externo. Se você quiser definir parâmetros para uso fora do webhook externo, defina-os em uma ação Snippet com o campo session_params. Por exemplo:
```
{
	"session_params":
	{ 
		"name": "Winnie Le Pooh"
		"job": "Food critic"
		"location": "Hundred Acre Wood"
	}
}
```
Acesse os parâmetros de sessão no intent do agente CX Dialogflow usando a seguinte sintaxe:

$session.params.name = Winnie Le Pooh

$session.params.job = Food critic

$session.params.location = 100 Acre Wood

Os parâmetros de sessão são usados apenas com agentes virtuais Dialogflow CX. Para obter um resultado semelhante com Dialogflow ES, use contextos.
Dicas de contexto de fala pode ser passadas com carga útil personalizada no parâmetro speechContexts. O valor de speechContexts.phrases deve ser um token da classe Google para a dica que você quer dar. O token deve corresponder ao idioma e à localidade dos seus contatos. Por exemplo:
```
DYNAMIC customPayload
customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
customPayload.speechContexts.boost=10		
```

Best Practices for Custom Payload with Google Dialogflow ES

When using this action with Google Dialogflow ES, follow these best practices for integrating custom payloads:

CustomPayload é usado para passar contexto para uma intenção O significado ou propósito por trás do que um contato diz/digita; o que o contato quer comunicar ou alcançar.. O contexto ajuda o agente virtual a entender a intenção do usuário. Os contextos não são obrigatórios, mas ajudam o agente virtual corresponder um enunciado O que um contato diz ou digita. a uma intenção.
Em uma ação Snippet em seu script, crie um objeto customPayload que segue o formato descrito na documentação do Google Dialogflow ES para o recurso REST: projects.agent.sessions.context. A ajuda online do Studio fornece informações adicionais sobre objetos de dados dinâmicos.
Você também pode passar dados personalizados com customPayload sem contextos. Para fazer isso, inclua pares de chave-valor JSON padrão em um objeto de dados dinâmicos.
Os contextos de fala são passados na carga útil personalizada no parâmetro speech_contact. Você pode ver o conteúdo desse parâmetro em rastreios do Studio e logs do aplicativo.
O objeto dinâmico customPayload é passado como um parâmetro de agente virtual como JSON, conforme mostrado no script de exemplo.
Dicas de contexto de fala pode ser passadas com carga útil personalizada no parâmetro speechContexts. O valor de speechContexts.phrases deve ser um token da classe Google para a dica que você quer dar. O token deve corresponder ao idioma e à localidade dos seus contatos. Por exemplo:
```
DYNAMIC customPayload
customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
customPayload.speechContexts.boost=10		
```

Script Example

Este exemplo não é um script completo. Trabalho de script adicional é necessário para usar esta ação.

A script example showing the Voicebot Conversation action.

Download this script.

Script Example CustomPayload with Google Dialogflow ES

Este exemplo não é um script completo. Trabalho de script adicional é necessário para usar esta ação.

Este script é um exemplo de como integrar cargas úteis personalizadas com agentes virtuais do Google Dialogflow ES. Este script usa a ação Voicebot Exchange, mas também funcionará se você usar TEXTBOT EXCHaNGE.

Um exemplo de script mostrando como lidar com carga útil personalizada usando o Google Dialogflow CX.

Baixe este script.

Example Script for Alternate Timeout Events

Você pode usar diferentes eventos de tempo limite em diferentes pontos do seu script. Por exemplo, você pode querer usar eventos de tempo limite diferentes na primeira e na segunda vez que a propriedade UserInputTimeout for acionada. Este script de exemplo mostra uma maneira possível de fazer isso acontecer.

Neste script, as ações Snippet são usadas para criar e incrementar um contador de tempo limite. Após o segundo tempo limite, uma ação Snippet é usada para definir um evento de tempo limite diferente. O evento de tempo limite alternativo é passado da ação Snippet para a ação do voicebot por meio da propriedade automatedIntent .

Baixe este script .